home *** CD-ROM | disk | FTP | other *** search
/ AMP Graphics Collection / AMP Graphics Collection.iso / programs / author / windirs / readme.mac < prev    next >
Text File  |  1996-07-26  |  5KB  |  108 lines
  1. WinDirs XObject
  2. --------------
  3. Version 1.0, 7/26/96
  4. Copyright ⌐ 1996, Glenn M. Picher
  5. Dirigo Multimedia
  6. Email: gpicher@maine.com
  7. Web: http://www.maine.com/shop/gpicher
  8. Phone: (207)767-8015 (South Portland, Maine)
  9.  
  10. Distribute freely. No licensing required.
  11.  
  12. Also distributed by:
  13. ------------------
  14. g/matter, inc.
  15. Email: support@gmatter.com
  16. Web: http://www.gmatter.com
  17. Phone: (415) 243-0394
  18.  
  19. Storing user or installation information with WinDirs
  20. ------------------------------------------------
  21. The WinDirs XObject allows you to detect the name of the Windows
  22. and System directories. This can be very handy when you need to store
  23. information in a standard location on every Windows machine. It's 
  24. often used to store a small private .INI file which indicates the 
  25. actual installed location of a Director presentation on the hard 
  26. drive.
  27.  
  28. If you build installers  with Indigo Rose Setup Factory or  Stirling 
  29. InstallSHIELD, to name but two of the many serviceable Windows 
  30. installation generators, you can create a private .INI file in the
  31. Windows directory which contains a section and a keyword value
  32. with the user's choice of installation directory. Then your Director 
  33. code running from a CD can locate the installed software, using the 
  34. WinDirs XObject. This can also be particularly useful when designing 
  35. CDs that automatically run when inserted (using Windows 95's AutoRun 
  36. feature, and QuickTime 2.0 and later's AutoStart feature on the 
  37. Macintosh). The application that starts automatically can determine 
  38. whether to run the installer if no private .INI file yet exists, or 
  39. run the already-installed copy in the location on the hard drive 
  40. indicated by the private .INI file in the Windows folder.
  41.  
  42. There is no direct equivalent of the Windows directory on the Mac, so
  43. the WinDirs XObject only exists for Windows. You can, however,
  44. use the PrefsFolder XObject, also from Dirigo Multimedia, and also 
  45. *free*, to detect the Preferences folder on the startup disk, where 
  46. preferences files can be stored. Same strategy, but a slightly 
  47. different XObject implementation.
  48.  
  49. The demo movie accompanying the WinDirs XObject is in Director 4
  50. format, but will open and work without modification under
  51. Director 5 (except under Windows NT 32-bit Director 5; see 
  52. below). There is a sample cut-n-paste Lingo handler script
  53. castmember which can get you up and running with the WinDirs
  54. XObject immediately.
  55.  
  56. Bugs
  57. ----
  58. No known bugs.
  59.  
  60. Quirks
  61. ------
  62. Director 5 32-bit projectors, and the 32-bit Director 5 authoring
  63. environment itself, are not able to load and use inherently 16-bit
  64. XObjects under Windows NT. This is not a problem under Windows 95,
  65. and Director 5 16-bit projectors *can* use XObjects under Windows NT.
  66. The Director 5 16-bit authoring environment does not operate at all
  67. under Windows NT, however. This means that you have to author
  68. Windows NT projects under Windows 3.1 or Windows 95 if you
  69. need to use XObjects, testing your development efforts under NT.
  70.  
  71. I expect to release a .x32 Xtra version of WinDirs soon to eliminate
  72. this restriction under Windows NT.
  73.  
  74. Under Windows NT, 16-bit applications use a different System
  75. directory than 32-bit applications. The WinDirs XObject always
  76. returns the 16-bit System directory. This may be an issue if
  77. your installer is a 32-bit application; it will place system
  78. files into a different directory than the one reported by
  79. WinDirs' mSystemDirectory method. The Windows directory,
  80. however, is the same for 16-bit and 32-bit applications
  81. in all current Windows versions.
  82.  
  83. Revision history
  84. ---------------
  85. 7/26/96: Version 1.0
  86.          First public release. Added TestD4.dir demo movie.
  87. 6/4/96:  Unnumbered private version, not released publically, 
  88.          but shipped on a number of CD-ROM titles.
  89.  
  90. Standard legal disclaimer
  91. -------------------------
  92. This software is provided "as is" without warranty of any kind, either
  93. expressed or  implied, including, but not limited to, the implied
  94. warranties of merchantability or fitness for a particular purpose.
  95. The software or its documentation or sample code may include errors
  96. or technical inaccuracies. Changes are periodically made to this
  97. software, its documentation and sample code, and may be incorporated
  98. in new versions. Dirigo Multimedia and g/matter may improve or
  99. change their products at any time without notice.  Dirigo Multimedia
  100. and g/matter assume no responsibility for and disclaim all
  101. liability for errors in this software or its documentation and sample
  102. code.  Neither Dirigo Multimedia nor g/matter will be responsible for
  103. any damages of any sort under any conditions. While the WinDirs
  104. XObject contains no known bugs, use it at your own risk. As always,
  105. you should make frequent backups of important information.
  106. Some jurisdictions do not allow the exclusion of implied
  107. warranties, so the above exclusion may not apply to you.
  108.